home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-madman-dsa-mib-02.txt < prev    next >
Text File  |  1993-08-19  |  33KB  |  1,064 lines
  1.  
  2.  
  3. MADMAN Working Group                   Glenn Mansfield [glenn@aic.co.jp]
  4. INTERNET-DRAFT                                    AIC Systems Laboratory
  5.                                   S.E.Hardcastle-Kille [steve@isode.com]
  6.                                                         ISODE Consortium
  7.                                                              August 1993
  8.  
  9.  
  10.                         Directory Monitoring MIB
  11.  
  12.  
  13. Status of this Memo
  14.  
  15.    This document is an  Internet  Draft.  Internet  Drafts  are  working
  16.    documents  of  the Internet Engineering Task Force (IETF), its Areas,
  17.    and its Working Groups. Note that other groups  may  also  distribute
  18.    working documents as Internet Drafts.
  19.  
  20.    Internet Drafts are draft  documents  valid  for  a  maximum  of  six
  21.    months.  Internet  Drafts  may  be updated, replaced, or obsoleted by
  22.    other documents at any time.  It is not appropriate to  use  Internet
  23.    Drafts as reference material or to cite them other than as a "working
  24.    draft" or "work in progress."
  25.  
  26.    To learn the current status of any Internet-Draft, please  check  the
  27.    1id-abstracts.txt  listing  contained  in  the Internet-Drafts Shadow
  28.    Directories on ds.internic.net, nic.nordu.net,  ftp.nisc.sri.com,  or
  29.    munnari.oz.au.
  30.  
  31.  
  32. Abstract
  33.  
  34. This  document  defines  an  experimental  portion  of  the   Management
  35. Information  Base  (MIB).  It  defines  the MIB for monitoring Directory
  36. System Agents[DSA], a component of the OSI Directory. This MIB  will  be
  37. used  in  conjunction  with the APPLICATION-MIB for monitoring DSAs.
  38.  
  39.  
  40.                         Contents
  41.                         ========
  42.         1.The SNMPv2 Network Management Framework.      2
  43.         2.MIB Model for DSA  Management                 2
  44.         3.The DSA functions and operations.             3
  45.         4.MIB design.                                   4
  46.         5.The Directory Monitoring MIB                  4
  47.         6.Acknowledgements                             17
  48.         7.References                                   18
  49.         Security Considerations
  50.         Authors' Addresses
  51.  
  52.  
  53.  
  54. Expires: February 25, 1994                                      [Page 1]
  55.  
  56. Internet Draft                                               August 1993
  57.  
  58.  
  59. 1.The SNMPv2 Network Management Framework.
  60. ==========================================
  61.  
  62. The major components of the SNMPv2 Network Management framework  are
  63. described in the documents listed below.
  64.  
  65.       o RFC 1442 [1] defines the Structure of Management Information
  66.         (SMI), the mechanisms used for describing and naming objects
  67.         for the purpose of management.
  68.       o RFC 1213 [2] defines MIB-II, the core set of managed objects
  69.         (MO) for the Internet suite of protocols.
  70.       o RFC 1445 [3] defines the administrative and other
  71.         architectural aspects of the management framework.
  72.       o RFC 1448 [4] defines the protocol used for network access to
  73.         managed objects.
  74.  
  75. The framework is adaptable/extensible by defining new  MIBs  to suit the
  76. requirements of specific applications/protocols/situations.
  77.  
  78. Managed objects are accessed via a virtual information store,  the  MIB.
  79. Objects  in  the  MIB  are  defined  using the subset of Abstract Syntax
  80. Notation One (ASN.1) defined in the SMI. In particular, each object type
  81. is  named by an OBJECT IDENTIFIER, which is an administratively assigned
  82. name. The object  type  together  with  an  object  instance  serves  to
  83. uniquely  identify  a  specific  instantiation  of the object. For human
  84. convenience, often a textual string, termed the  descriptor,is  used  to
  85. refer to the object type.
  86.  
  87.  
  88. 2. MIB Model for  DSA  Management.
  89. =================================
  90.  
  91. A DSA-manager may wish to monitor  several  aspects of  the  operational
  92. DSA.  He/she  may  want  to  know  the process related aspects- the CPU,
  93. memory, .. utilization of the operational  DSA;   the   network  service
  94. related    aspects    -   inbound-associations,   outbound-associations,
  95. operational status, ... and finally the information specific to the  DSA
  96. application- its operations and performance.
  97.  
  98. The MIB proposed in this document covers only  the   portion   which  is
  99. specific   to  the  DSA-application. The network service related part of
  100. the MIB, and the host-resources related part, of the  MIB  ,   as   well
  101. other   parts  of  interest to a Manager monitoring the DSA-application,
  102. are covered in separate  documents  [6][7].  The  relationship  of  this
  103. MIB with the other MIBs is shown in fig.1.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110. Expires: February 25, 1994                                      [Page 2]
  111.  
  112. Internet Draft                                               August 1993
  113.  
  114.  
  115.  
  116.                    +----------------------+
  117.                    |  Host Resources MIB  |
  118.                    +----------------------+
  119.                    |                      |
  120.                    |  DSA-specific MIB    |
  121.                    |                      |
  122.                    +----------------------|
  123.                    |  generic NSA MIB     |
  124.                    +----------------------+
  125.                    |      Other MIBs      |
  126.                    |    [MIB-II, ... ]    |
  127.                    +----------------------+
  128.  
  129.                             Fig. 1
  130. The manager (application) of a network service   application   will  use
  131. the  Host Resources MIB to obtain process related information [ resource
  132. usage,..], the Network Service Application (NSA)  MIB  for  generic  NSA
  133. related  MOs.  The DSA-specific MIB is the one that is being proposed in
  134. this memo.
  135.  
  136. For   management   information   pertaining   to   the    lower    layer
  137. TCP/UDP/IP/... the MIB-II offers the repertoire of MOs.
  138.  
  139.  
  140. 3.The DSA functions and operations.
  141. ==================================
  142.  
  143. The Directory System Agent [DSA], a component of the  OSI-Directory,  is
  144. an  application process. It provides access to the Directory Information
  145. Base  [DIB]  to  Directory  User  Agents  [DUA]   and/or   other   DSAs.
  146. Functionally , a User [ DUA ] and the Directory are bound together for a
  147. period of time at an access point to the Directory [DSA]. A DSA may  use
  148. information  stored  in  its  local database or interact with (chain the
  149. request to) other DSAs to service requirements. Alternatively, a DSA may
  150. return a reference to another DSA.
  151.  
  152. The local database of a DSA consists of the part  of  the  DIT  that  is
  153. mastered by the DSA, the part of the DIT for which it keeps slave copies
  154. and cached information that is gathered during the operation of the DSA.
  155.  
  156. The specific operations carried out by the  DSA  are  :  Read,  Compare,
  157. AddEntry,  ModifyEntry,  ModifyRDN,  RemoveEntry, List, Search. There is
  158. also the special operation Abandon.  In  response  to  requests  results
  159. and/or errors are returned by the DSA.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166. Expires: February 25, 1994                                      [Page 3]
  167.  
  168. Internet Draft                                               August 1993
  169.  
  170.  
  171. 4. MIB design.
  172. =============
  173.  
  174. The basic principle has been to keep the MIB as simple as  possible. The
  175. Managed  objects  included in the MIB are divided into three tables- the
  176. dsaOpsTable dsaEntryTable and dsaIntTable.
  177.  
  178.    - The dsaOpsTable  provides  summary statistics on the accesses,
  179.      operations errors.
  180.  
  181.    - The dsaEntriesTable  provides  summary statistics on the entries
  182.      held by the DSA and on cache performance.
  183.  
  184.    - The dsaIntTable  provides some useful information on the
  185.      interaction of the monitored DSA with peer DSAs.
  186.  
  187. There   are  references   to   the    Directory   itself   for    static
  188. information  pertaining  to the DSA. These references are in the form of
  189. "Directory Distinguished Name" [5] of the corresponding object.  It   is
  190. intended  that  DSA management applications will use these references to
  191. obtain  further  related information on the objects of interest.
  192.  
  193. 5. The Directory Monitoring MIB.
  194. ===============================
  195.  
  196.  
  197. DSA-MIB DEFINITIONS ::= BEGIN
  198.  
  199.         IMPORTS
  200.           MODULE-IDENTITY,  OBJECT-TYPE,
  201.           NOTIFICATION-TYPE,experimental
  202.                      FROM SNMPv2-SMI
  203.           DisplayString
  204.                      FROM SNMPv2-TC;
  205.  
  206. -- textual conventions
  207. -- Distinguished Name [5]- is used to refer to objects in the directory.
  208.  
  209.         DistinguishedName::= DisplayString
  210.  
  211.         dsaMIB MODULE-IDENTITY
  212.            LAST-UPDATED "9308190000Z"
  213.            ORGANIZATION "IETF MADMAN Working Group"
  214.         CONTACT-INFO
  215.            "        Glenn Mansfield
  216.             Postal: AIC Systems Laboratory
  217.                     6-6-3, Minami Yoshinari
  218.                     Aoba-ku, Sendai, Japan 989-32.
  219.  
  220.  
  221.  
  222. Expires: February 25, 1994                                      [Page 4]
  223.  
  224. Internet Draft                                               August 1993
  225.  
  226.  
  227.             Tel: +81-22-279-3310
  228.             Fax: +81-22-279-3640
  229.             E-mail: glenn@aic.co.jp"
  230.          DESCRIPTION
  231.             "The MIB module for monitoring Directory System Agents"
  232.          ::= { experimental 48 }
  233.  
  234.  
  235.  
  236.         dsaMIBObjects OBJECT IDENTIFIER ::= { dsaMIB 1}
  237.         dsaOpsTable OBJECT-TYPE
  238.             SYNTAX SEQUENCE OF DsaOpsEntry
  239.             MAX-ACCESS not-accessible
  240.             STATUS mandatory
  241.             DESCRIPTION
  242.                 "The table holding information related to the
  243.                  DSA operations"
  244.             ::= {dsaMIBObjects 1}
  245.  
  246.         dsaOpsEntry OBJECT-TYPE
  247.             SYNTAX DsaOpsEntry
  248.             MAX-ACCESS not-accessible
  249.             STATUS mandatory
  250.             DESCRIPTION
  251.               "Entry containing operations related statistics for a DSA"
  252.             INDEX { dsaApplIndex }
  253.             ::= {dsaOpsTable 1}
  254.  
  255.         DsaOpsEntry ::= SEQUENCE {
  256.             dsaApplIndex
  257.                 INTEGER,
  258.  
  259. --bindings
  260.             dsaAnonymousBinds
  261.                 Counter32,
  262.             dsaUnauthBinds
  263.                 Counter32,
  264.             dsaSimpleAuthBinds
  265.                 Counter32,
  266.             dsaStrongAuthBinds
  267.                 Counter32,
  268.             dsaBindSecurityErrors
  269.                 Counter32,
  270.  
  271.  --  in-coming operations
  272.  
  273.             dsaInOps
  274.                 Counter32,
  275.  
  276.  
  277.  
  278. Expires: February 25, 1994                                      [Page 5]
  279.  
  280. Internet Draft                                               August 1993
  281.  
  282.  
  283.  -- locally executed
  284.  
  285.             dsaReadOps
  286.                 Counter32,
  287.             dsaCompareOps
  288.                 Counter32,
  289.             dsaAddEntryOps
  290.                 Counter32,
  291.             dsaRemoveEntryOps
  292.                 Counter32,
  293.             dsaModifyEntryOps
  294.                 Counter32,
  295.             dsaModifyRDNOps
  296.                 Counter32,
  297.             dsaListOps
  298.                 Counter32,
  299.             dsaSearchOps
  300.                 Counter32,
  301.             dsaOneLevelSearchOps
  302.                 Counter32,
  303.             dsaWholeTreeSearchOps
  304.                 Counter32,
  305.  
  306.   --  out going operations
  307.  
  308.             dsaReferrals
  309.                 Counter32,
  310.             dsaChainings
  311.                 Counter32,
  312.  
  313.   -- errors
  314.  
  315.             dsaSecurityErrors
  316.                 Counter32,
  317.             dsaErrors
  318.                 Counter32
  319.         }
  320.  
  321.         dsaApplIndex OBJECT-TYPE
  322.             SYNTAX INTEGER
  323.             MAX-ACCESS not-accessible
  324.             STATUS mandatory
  325.             DESCRIPTION
  326.               "Reference into application table to allow
  327.                correlation with general application
  328.                parameters"
  329.             ::= {dsaOpsEntry 1}
  330.  
  331.  
  332.  
  333.  
  334. Expires: February 25, 1994                                      [Page 6]
  335.  
  336. Internet Draft                                               August 1993
  337.  
  338.  
  339. -- for more information on the DSA [Contact person , Directory
  340. -- Distinguished  Name ...  ] the corresponding ApplEntry
  341. -- [ applicationIndex = dsaApplIndex] in the applTable should
  342. -- should be looked up.
  343. -- [ the dsa's appn entry-id = experimental.46.1.1.dsaApplIndex ]
  344.  
  345.         dsaAnonymousBinds OBJECT-TYPE
  346.             SYNTAX INTEGER
  347.             MAX-ACCESS read-only
  348.             STATUS mandatory
  349.             DESCRIPTION
  350.               " Number of anonymous (DAP) binds to this DSA
  351.                 since application start"
  352.             ::= {dsaOpsEntry 2}
  353.  
  354.         dsaUnauthBinds OBJECT-TYPE
  355.             SYNTAX INTEGER
  356.             MAX-ACCESS read-only
  357.             STATUS mandatory
  358.             DESCRIPTION
  359.               " Number of un-authenticated binds to this
  360.                 DSA , since application start"
  361.             ::= {dsaOpsEntry 3}
  362.  
  363.         dsaSimpleAuthBinds OBJECT-TYPE
  364.             SYNTAX INTEGER
  365.             MAX-ACCESS read-only
  366.             STATUS mandatory
  367.             DESCRIPTION
  368.               " Number of binds to this DSA that were authenticated
  369.                 using simple authentication procedures, since
  370.                 application start"
  371.             ::= {dsaOpsEntry 4}
  372.  
  373.         dsaStrongAuthBinds OBJECT-TYPE
  374.             SYNTAX INTEGER
  375.             MAX-ACCESS read-only
  376.             STATUS mandatory
  377.             DESCRIPTION
  378.               " Number of binds to this DSA that were authenticated
  379.                 using the strong authentication procedures, since
  380.                 application start. This includes the binds that were
  381.                 authenticated using external authentication procedures"
  382.             ::= {dsaOpsEntry 5}
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390. Expires: February 25, 1994                                      [Page 7]
  391.  
  392. Internet Draft                                               August 1993
  393.  
  394.  
  395.         dsaBindSecurityErrors OBJECT-TYPE
  396.             SYNTAX INTEGER
  397.             MAX-ACCESS read-only
  398.             STATUS mandatory
  399.             DESCRIPTION
  400.               " number of bind operations that have been rejected
  401.                 by this DSA due to inappropriateAuthentication or
  402.                 invalidCredentials."
  403.             ::= {dsaOpsEntry 6}
  404.  
  405.         dsaInOps OBJECT-TYPE
  406.             SYNTAX INTEGER
  407.             MAX-ACCESS read-only
  408.             STATUS mandatory
  409.             DESCRIPTION
  410.               " Number of operations forwarded to this DSA
  411.                 from DUAs or other DSAs , since application
  412.                 start up"
  413.             ::= {dsaOpsEntry 7}
  414.  
  415.         dsaReadOps OBJECT-TYPE
  416.             SYNTAX INTEGER
  417.             MAX-ACCESS read-only
  418.             STATUS mandatory
  419.             DESCRIPTION
  420.               " number of read operations locally executed by
  421.                 this DSA since application startup."
  422.             ::= {dsaOpsEntry 8}
  423.  
  424.         dsaCompareOps OBJECT-TYPE
  425.             SYNTAX INTEGER
  426.             MAX-ACCESS read-only
  427.             STATUS mandatory
  428.             DESCRIPTION
  429.               " number of compare operations locally executed by
  430.                 this DSA  since application startup."
  431.             ::= {dsaOpsEntry 9}
  432.  
  433.         dsaAddEntryOps OBJECT-TYPE
  434.             SYNTAX INTEGER
  435.             MAX-ACCESS read-only
  436.             STATUS mandatory
  437.             DESCRIPTION
  438.               " number of addEntry operations locally executed by
  439.                 this DSA since application startup."
  440.             ::= {dsaOpsEntry 10}
  441.  
  442.  
  443.  
  444.  
  445.  
  446. Expires: February 25, 1994                                      [Page 8]
  447.  
  448. Internet Draft                                               August 1993
  449.  
  450.  
  451.         dsaRemoveEntryOps OBJECT-TYPE
  452.             SYNTAX INTEGER
  453.             MAX-ACCESS read-only
  454.             STATUS mandatory
  455.             DESCRIPTION
  456.               " number of removeEntry operations locally executed by
  457.                 this DSA since application startup."
  458.             ::= {dsaOpsEntry 11}
  459.  
  460.         dsaModifyEntryOps OBJECT-TYPE
  461.             SYNTAX INTEGER
  462.             MAX-ACCESS read-only
  463.             STATUS mandatory
  464.             DESCRIPTION
  465.               " number of modifyEntry operations locally executed by
  466.                 this DSA since application startup."
  467.             ::= {dsaOpsEntry 12}
  468.  
  469.         dsaModifyRDNOps OBJECT-TYPE
  470.             SYNTAX INTEGER
  471.             MAX-ACCESS read-only
  472.             STATUS mandatory
  473.             DESCRIPTION
  474.               " number of modifyRDN operations locally executed by
  475.                 this DSA since application startup."
  476.             ::= {dsaOpsEntry 13}
  477.  
  478.         dsaListOps OBJECT-TYPE
  479.             SYNTAX INTEGER
  480.             MAX-ACCESS read-only
  481.             STATUS mandatory
  482.             DESCRIPTION
  483.               " number of list operations locally executed by
  484.                 this DSA since application startup."
  485.             ::= {dsaOpsEntry 14}
  486.  
  487.         dsaSearchOps OBJECT-TYPE
  488.             SYNTAX INTEGER
  489.             MAX-ACCESS read-only
  490.             STATUS mandatory
  491.             DESCRIPTION
  492.               " number of search operations- baseObjectSearches,
  493.                 oneLevelSearches and  subTreeSearches, locally
  494.                 executed by this DSA  since application startup."
  495.             ::= {dsaOpsEntry 15}
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502. Expires: February 25, 1994                                      [Page 9]
  503.  
  504. Internet Draft                                               August 1993
  505.  
  506.  
  507.         dsaOneLevelSearchOps OBJECT-TYPE
  508.             SYNTAX INTEGER
  509.             MAX-ACCESS read-only
  510.             STATUS mandatory
  511.             DESCRIPTION
  512.               " number of oneLevelSearch operations locally executed
  513.                 by this DSA since application startup."
  514.             ::= {dsaOpsEntry 16}
  515.  
  516.         dsaWholeTreeSearchOps   OBJECT-TYPE
  517.             SYNTAX INTEGER
  518.             MAX-ACCESS read-only
  519.             STATUS mandatory
  520.             DESCRIPTION
  521.               " number of wholeTreeSearch operations locally executed
  522.                 by this DSA since application startup."
  523.             ::= {dsaOpsEntry 17}
  524.  
  525.         dsaReferrals OBJECT-TYPE
  526.             SYNTAX INTEGER
  527.             MAX-ACCESS read-only
  528.             STATUS mandatory
  529.             DESCRIPTION
  530.               " number of referrals returned by this DSA in response
  531.                 to requests for operations since application startup."
  532.             ::= {dsaOpsEntry 18}
  533.  
  534.         dsaChainings OBJECT-TYPE
  535.             SYNTAX INTEGER
  536.             MAX-ACCESS read-only
  537.             STATUS mandatory
  538.             DESCRIPTION
  539.               " number of operations forwarded by this DSA
  540.                 to other DSAs since application startup."
  541.             ::= {dsaOpsEntry 19}
  542.  
  543.         dsaSecurityErrors OBJECT-TYPE
  544.             SYNTAX INTEGER
  545.             MAX-ACCESS read-only
  546.             STATUS mandatory
  547.             DESCRIPTION
  548.               " number of operations forwarded to this DSA
  549.                 which did not meet the security requirements "
  550.             ::= {dsaOpsEntry 20}
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558. Expires: February 25, 1994                                     [Page 10]
  559.  
  560. Internet Draft                                               August 1993
  561.  
  562.  
  563.         dsaErrors        OBJECT-TYPE
  564.             SYNTAX INTEGER
  565.             MAX-ACCESS read-only
  566.             STATUS mandatory
  567.             DESCRIPTION
  568.               " number of operations that could not be serviced
  569.                 due to errors other than security errors, and
  570.                 referrals.
  571.                 A partially serviced operation will not be counted
  572.                 as an error.
  573.                 The errors include NameErrors, UpdateErrors, Attribute
  574.                 errors and ServiceErrors."
  575.             ::= {dsaOpsEntry 21}
  576.  
  577. --  Entry statistics/Cache performance
  578.  
  579.         dsaEntriesTable OBJECT-TYPE
  580.             SYNTAX SEQUENCE OF DsaEntriesEntry
  581.             MAX-ACCESS not-accessible
  582.             STATUS mandatory
  583.             DESCRIPTION
  584.                 "The table holding information related to the
  585.                  cache performance of the DSAs"
  586.             ::= {dsaMIBObjects 2}
  587.  
  588.         dsaEntriesEntry OBJECT-TYPE
  589.             SYNTAX DsaEntriesEntry
  590.             MAX-ACCESS not-accessible
  591.             STATUS mandatory
  592.             DESCRIPTION
  593.               "Entry containing statistics pertaining to entries
  594.                held by a DSA"
  595.             INDEX { dsaApplIndex }
  596.             ::= {dsaTable 1}
  597.  
  598.         DsaEntriesEntry ::= SEQUENCE {
  599.             dsaMasterEntries
  600.                 INTEGER,
  601.             dsaCopyEntries
  602.                 INTEGER,
  603.             dsaCacheEntries
  604.                 INTEGER,
  605.             dsaCacheHits
  606.                 Counter32,
  607.             dsaSlaveHits
  608.                 Counter32
  609.         }
  610.  
  611.  
  612.  
  613.  
  614. Expires: February 25, 1994                                     [Page 11]
  615.  
  616. Internet Draft                                               August 1993
  617.  
  618.  
  619.         dsaMasterEntries OBJECT-TYPE
  620.             SYNTAX INTEGER
  621.             MAX-ACCESS read-only
  622.             STATUS mandatory
  623.             DESCRIPTION
  624.               "Number of Entries mastered in the DSA"
  625.             ::= {dsaEntriesEntry 1}
  626.  
  627.         dsaCopyEntries OBJECT-TYPE
  628.             SYNTAX INTEGER
  629.             MAX-ACCESS read-only
  630.             STATUS mandatory
  631.             DESCRIPTION
  632.               "Number of Entries with systematic (slave)
  633.                copies maintained in the DSA"
  634.             ::= {dsaEntriesEntry 2}
  635.  
  636.         dsaCacheEntries OBJECT-TYPE
  637.             SYNTAX INTEGER
  638.             MAX-ACCESS read-only
  639.             STATUS mandatory
  640.             DESCRIPTION
  641.               "Number of Entries cached (non-systematic
  642.                copies) in the DSA"
  643.             ::= {dsaEntriesEntry 3}
  644.  
  645.         dsaCacheHits OBJECT-TYPE
  646.             SYNTAX INTEGER
  647.             MAX-ACCESS read-only
  648.             STATUS mandatory
  649.             DESCRIPTION
  650.               " number of operations that were serviced from
  651.                 the locally held cache, since application
  652.                 startup."
  653.             ::= {dsaEntriesEntry 4}
  654.  
  655.         dsaSlaveHits  OBJECT-TYPE
  656.             SYNTAX INTEGER
  657.             MAX-ACCESS read-only
  658.             STATUS mandatory
  659.             DESCRIPTION
  660.               " number of operations that were serviced from
  661.                 the locally held object replications [ shadow
  662.                 entries] since application startup."
  663.             ::= {dsaEntriesEntry 5}
  664.  
  665.  
  666.   -- The dsaIntTable contains statistical data on the DSAs
  667.  
  668.  
  669.  
  670. Expires: February 25, 1994                                     [Page 12]
  671.  
  672. Internet Draft                                               August 1993
  673.  
  674.  
  675.   -- with which a DSA [attempts to] interact.  This table  will
  676.   -- provide a useful insight into  the effect of neighbours
  677.   -- on the DSA performance.
  678.   -- Due to resource constraints it may be necessary to
  679.   -- delete entries. It is suggested that the least recently
  680.   -- used entries be deleted first. The size of the table and
  681.   -- procedures for its maintenance will be left to the
  682.   -- implementation.
  683.  
  684.           dsaIntTable OBJECT-TYPE
  685.                   SYNTAX  SEQUENCE OF DsaIntEntry
  686.                   MAX-ACCESS  not-accessible
  687.                   STATUS  mandatory
  688.                   DESCRIPTION
  689.                     "each row of this table contains some details
  690.                      related to the history of the interaction
  691.                      of the DSAs mastered locally with other DSAs"
  692.                   ::= { dsaMIBObjects 3 }
  693.  
  694.           dsaIntEntry OBJECT-TYPE
  695.                   SYNTAX  DsaIntEntry
  696.                   MAX-ACCESS  not-accessible
  697.                   STATUS  mandatory
  698.             DESCRIPTION
  699.                     "entry containing interaction details of a DSA
  700.                      with a peer DSA"
  701.             INDEX { dsaApplIndex,dsaIntIndex }
  702.                   ::= { dsaIntTable 1 }
  703.  
  704.           DsaIntEntry ::= SEQUENCE {
  705.               dsaIntIndex
  706.                   INTEGER,
  707.               dsaName
  708.                   DistinguishedName,
  709.               dsaTimeOfCreation
  710.                   TimeTicks,
  711.               dsaTimeOfLastAttempt
  712.                   TimeTicks,
  713.               dsaTimeOfLastSuccess
  714.                   TimeTicks,
  715.               dsaFailuresSinceLastSuccess
  716.                   Counter32,
  717.               dsaFailures
  718.                   Counter32,
  719.               dsaSuccesses
  720.                   Counter32
  721.           }
  722.  
  723.  
  724.  
  725.  
  726. Expires: February 25, 1994                                     [Page 13]
  727.  
  728. Internet Draft                                               August 1993
  729.  
  730.  
  731.         dsaIntIndex  OBJECT-TYPE
  732.             SYNTAX INTEGER
  733.             MAX-ACCESS not-accessible
  734.             STATUS mandatory
  735.             DESCRIPTION
  736.               " together with dsaApplIndex it forms the unique key to
  737.                 identify the conceptual row which contains useful info
  738.                 on the (attempted) interaction between the DSA (referred
  739.                 to by dsaApplIndex) and another DSA."
  740.             ::= {dsaIntEntry 1}
  741.  
  742.         dsaName  OBJECT-TYPE
  743.             SYNTAX DistinguishedName
  744.             MAX-ACCESS read-only
  745.             STATUS mandatory
  746.             DESCRIPTION
  747.               " distinguished name of the DSA to which this
  748.                 entry pertains."
  749.             ::= {dsaIntEntry 2}
  750.  
  751.         dsaTimeOfCreation  OBJECT-TYPE
  752.             SYNTAX TimeTicks
  753.             MAX-ACCESS read-only
  754.             STATUS mandatory
  755.             DESCRIPTION
  756.               " The value of sysUpTime when this entry was created.
  757.                 If the entry was created before the network management
  758.                 subsystem was initialized, this object will contain
  759.                 a value of zero."
  760.             ::= {dsaIntEntry 3}
  761.  
  762.         dsaTimeOfLastAttempt  OBJECT-TYPE
  763.             SYNTAX TimeTicks
  764.             MAX-ACCESS read-only
  765.             STATUS mandatory
  766.             DESCRIPTION
  767.               " The value of sysUpTime when the last attempt was made
  768.                 to contact this DSA. If the last attempt was made before
  769.                 the network management subsystem was initialized, this
  770.                 object will contain a value of zero."
  771.             ::= {dsaIntEntry 4}
  772.  
  773.         dsaTimeOfLastSuccess  OBJECT-TYPE
  774.             SYNTAX TimeTicks
  775.             MAX-ACCESS read-only
  776.             STATUS mandatory
  777.             DESCRIPTION
  778.               " The value of sysUpTime when the last attempt made to
  779.  
  780.  
  781.  
  782. Expires: February 25, 1994                                     [Page 14]
  783.  
  784. Internet Draft                                               August 1993
  785.  
  786.  
  787.                 contact this DSA was successful. If there have
  788.                 been no successful attempts this entry will be
  789.                 0. If the last successful attempt was made before
  790.                 the network management subsystem was initialized, this
  791.                 object will contain a value of zero."
  792.             ::= {dsaIntEntry 5}
  793.  
  794.         dsaFailuresSinceLastSuccess  OBJECT-TYPE
  795.             SYNTAX Counter32
  796.             MAX-ACCESS read-only
  797.             STATUS mandatory
  798.             DESCRIPTION
  799.               " The number of failures since the last time an
  800.                 attempt to contact this DSA was successful."
  801.             ::= {dsaIntEntry 6}
  802.  
  803.         dsaFailures  OBJECT-TYPE
  804.             SYNTAX Counter32
  805.             MAX-ACCESS read-only
  806.             STATUS mandatory
  807.             DESCRIPTION
  808.               " cumulative failures since the creation of
  809.                 this entry."
  810.             ::= {dsaIntEntry 7}
  811.  
  812.         dsaSuccesses  OBJECT-TYPE
  813.             SYNTAX Counter32
  814.             MAX-ACCESS read-only
  815.             STATUS mandatory
  816.             DESCRIPTION
  817.               " cumulative successes since the creation of
  818.                 this entry."
  819.             ::= {dsaIntEntry 8}
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838. Expires: February 25, 1994                                     [Page 15]
  839.  
  840. Internet Draft                                               August 1993
  841.  
  842.  
  843.         -- conformance information
  844.  
  845.         dsaConformance OBJECT IDENTIFIER ::= { dsaMIB 2 }
  846.  
  847.         dsaGroups      OBJECT IDENTIFIER ::= { dsaConformance 1 }
  848.         dsaCompliances OBJECT IDENTIFIER ::= { dsaConformance 2 }
  849.  
  850.  
  851.         -- compliance statements
  852.  
  853.         dsaOpsCompliance MODULE-COMPLIANCE
  854.             STATUS  current
  855.             DESCRIPTION
  856.                     "The compliance statement for SNMPv2 entities
  857.                     which implement the dsa MIB for monitoring
  858.                     DSA operations."
  859.  
  860.             MODULE  -- this module
  861.                 MANDATORY-GROUPS { dsaOpsGroup }
  862.  
  863.             ::= { dsaCompliances 1 }
  864.  
  865.  
  866.         dsaEntryCompliance MODULE-COMPLIANCE
  867.             STATUS  current
  868.             DESCRIPTION
  869.                     "The compliance statement for SNMPv2 entities
  870.                     which implement the dsa MIB for monitoring
  871.                     DSA operations,  entry statistics and cache
  872.                     performance."
  873.  
  874.             MODULE  -- this module
  875.                 MANDATORY-GROUPS { dsaOpsGroup,dsaEntryGroup }
  876.  
  877.             ::= { dsaCompliances 2 }
  878.  
  879.  
  880.         dsaIntCompliance MODULE-COMPLIANCE
  881.             STATUS  current
  882.             DESCRIPTION
  883.                     "The compliance statement for SNMPv2 entities
  884.                     which implement the dsa MIB for monitoring
  885.                     DSAs interaction with other DSAs."
  886.  
  887.             MODULE  -- this module
  888.                 MANDATORY-GROUPS { dsaOpsGroup, dsaIntGroup }
  889.  
  890.             ::= { dsaCompliances 3 }
  891.  
  892.  
  893.  
  894. Expires: February 25, 1994                                     [Page 16]
  895.  
  896. Internet Draft                                               August 1993
  897.  
  898.  
  899.         -- units of conformance
  900.  
  901.         dsaOpsGroup    OBJECT-GROUP
  902.             OBJECTS {dsaApplIndex,        dsaAnonymousBinds,    dsaUnauthBinds,
  903.                      dsaSimpleAuthBinds,  dsaStrongAuthBinds,   dsaBindSecurityErrors,
  904.                      dsaInOps,            dsaReadOps,           dsaCompareOps,
  905.                      dsaAddEntryOps,      dsaRemoveEntryOps,    dsaModifyEntryOps,
  906.                      dsaModifyRDNOps,     dsaListOps,           dsaSearchOps,
  907.                      dsaOneLevelSearchOps,dsaWholeTreeSearchOps,dsaReferrals,
  908.                      dsaChainings,        dsaSecurityErrors,    dsaErrors}
  909.             STATUS  current
  910.             DESCRIPTION
  911.                     "A collection of objects for monitoring the DSA
  912.                      operations"
  913.             ::= { dsaGroups 1 }
  914.  
  915.         dsaEntryGroup    OBJECT-GROUP
  916.             OBJECTS {dsaMasterEntries,    dsaCopyEntries,       dsaCacheEntries,
  917.                      dsaCacheHits,        dsaSlaveHits}
  918.             STATUS  current
  919.             DESCRIPTION
  920.                     "A collection of objects for monitoring the DSA
  921.                      entry statistics and cache performance"
  922.             ::= { dsaGroups 2 }
  923.  
  924.         dsaIntGroup    OBJECT-GROUP
  925.             OBJECTS {dsaName,             dsaTimeOfCreation,    dsaTimeOfLastAttempt,
  926.                      dsaTimeOfLastSuccess,dsaFailuresSinceLastSuccess,dsaFailures,
  927.                      dsaSuccesses}
  928.             STATUS  current
  929.             DESCRIPTION
  930.                     "A collection of objects for monitoring the DSA
  931.                      interaction with other DSAs"
  932.             ::= { dsaGroups 3 }
  933.  
  934.  
  935. END
  936.  
  937.  
  938.  
  939. 6.  Acknowledgements
  940. ====================
  941. This draft is the product of discussions and deliberations carried out
  942. in the following working groups
  943.         ietf-madman-wg  ietf-madman@innosoft.com
  944.         wide-isode-wg   isode-wg@wide.ad.jp
  945.         wide-netman-wg  netman-wg@wide.ad.jp
  946.  
  947.  
  948.  
  949.  
  950. Expires: February 25, 1994                                     [Page 17]
  951.  
  952. Internet Draft                                               August 1993
  953.  
  954.  
  955. 7.  References
  956. ==============
  957.  
  958. [1]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S.,
  959.      "Structure of Management Information for version 2 of the Simple Network
  960.      Management Protocol (SNMPv2)", RFC1442, SNMP Research,Inc., Hughes LAN
  961.      Systems, Dover Beach Consulting, Inc., Carnegie Mellon University,April
  962.      1993.
  963.  
  964. [2]  McCloghrie, K., and Rose,M., Editors, "Management Information Base for
  965.      Network Management of TCP/IP-based internets: MIB-II", STD 17, RFC 1213,
  966.      Hughes LAN Systems, Performance Systems International, March 1991.
  967.  
  968. [3]  Galvin, J., McCloghrie, K., " Administrative Model for version 2 of the
  969.      Simple Network Management Protocol (SNMPv2)", RFC 1445, Trusted Information
  970.      Systems, Hughes LAN Systems, April 1993.
  971.  
  972. [4]  Case, J., McCloghrie, K., Rose, M., and Waldbusser, S.,
  973.      "Protocol Operations for version 2 of the Simple Network Management Protocol
  974.      (SNMPv2)", RFC1448, SNMP Research,Inc., Hughes LAN Systems, Dover Beach
  975.      Consulting, Inc., Carnegie Mellon University, April 1993.
  976.  
  977.  
  978. [5]  The X.500 blue book.
  979.  
  980. [6]  Freed, N., Kille, S., The Network Services Monitoring MIB,
  981.      Internet Draft, August 18, 1993.
  982.  
  983. [7]  Grillo, P., Waldbusser, S., Host Resources MIB, Internet Draft,
  984.      June, 1993.
  985.  
  986. [8]  Austein, R., Saperia J., DNS Resolver MIB, Internet Draft,
  987.      July 1993.
  988.  
  989. [9]  Austein, R., Saperia J., DNS Server MIB Extensions, Internet Draft,
  990.      July 1993.
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006. Expires: February 25, 1994                                     [Page 18]
  1007.  
  1008. Internet Draft                                               August 1993
  1009.  
  1010.  
  1011. Security Considerations.
  1012. ========================
  1013. Security issues are not discussed in this memo.
  1014.  
  1015. Authors' Addresses
  1016. ==================
  1017.  
  1018. Glenn Mansfield                                 Steve Hardcastle-Kille
  1019. AIC Systems Laboratories                        ISODE Consortium
  1020. 6-6-3 Minami Yoshinari                          Unit 309, The Chandlery
  1021. Aoba-ku                                         50 Westminster Bridge Road
  1022. Sendai 989-32                                   London SE1 7QY
  1023. Japan                                           England
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062. Expires: February 25, 1994                                     [Page 19]
  1063.  
  1064.